SHADESYMBOL <symbol>
 
selects the current shade symbol from the current shadeset file.
 
argument
 
<symbol> - specifies the symbol number of a shade symbol defined in a
shadeset file.  This symbol will become the current shade symbol.  <symbol>
must be an integer between 1 and 999.  There is no default <symbol> number
because when ARCPLOT starts up, the current shade symbol is set to the hardware
default.
 
notes
 
If you do not give the SHADESET command to access a specific shadeset
file before you give the SHADESYMBOL command, SHADESYMBOL will access a symbol
number from the default SHADESET file.
 
A shadeset file is a system file that stores symbol definitions for a set of up
to 999 shade symbols.  Each symbol is identified by a symbol number between 1
and 999.  This symbol number is specified in the SHADESYMBOL command to select
a shade symbol from a shadeset file to be the current shade symbol.
 
ARCPLOT maintains 1035 numbered locations in memory for retaining symbol
definitions.  Symbol numbers 1011-1035 are reserved for template symbols used
in the SHADEEDIT menu.  Symbol numbers 1001-1010 are reserved for ARCPLOT
transactions only.  The current symbol is always copied to the location of
1000, replacing the previous settings.  (This is why you can have only 999
symbols, or a symbol other than 1000.)  Using the symbol location 1000 to store
your current shade characteristics edits enables you to make changes to the
current settings without altering a specified shade symbol.
 
Once you have set the current symbol with the SHADESYMBOL command, you can
still change the individual characteristics of the current shade symbol by
giving commands like SHADECOLOR, SHADESIZE, SHADESEPARATION, etc.
 
Giving SHADESYMBOL as 0 specifies that no current shade symbol will be drawn.
No current shade symbol will be drawn until SHADESYMBOL is given again with a
valid shade symbol number.
 
Each ARCPLOT shade symbol is made up of a number of layers.  Each layer is a
separate shade design.  Simple shade symbols will only have one layer.  More
complex shade symbols will feature several layers.
 
The following commands specify the characteristics of the current shade symbol:
 
SHADEANGLE
SHADECOLOR
SHADEOFFSET
SHADEPATTERN
SHADEPEN
SHADESEPARATION
SHADESIZE
SHADETYPE
 
When you give one of these commands, it will apply to all of the layers in the
current shade symbol unless the SHADELAYER command has been given to specify
one of the layers.  If you give SHADELAYER, any changes made to the current
shade symbol will only apply to the specified layer.
 
These are the characteristics of the default shade symbol:
 
SHADEANGLE  0
SHADECOLOR  1
SHADEOFFSET  0
SHADEPATTERN  0
SHADEPEN  0  BUTT  MITER
SHADESEPARATION  0
SHADESIZE  0
SHADETYPE  HARDWARE
 
This default shade is not taken from a shadeset file and has no SHADESYMBOL
number.
 
To apply the current shade layer edits to a specified shade symbol for reuse
within the current ARCPLOT session, use the SHADEPUT command.
 
To save the current shade layer edits to a specified shadeset file for use
within any ARCPLOT session, use the SHADESAVE command.
 
To list the parameter(s) of the current or a specific shade symbol, use the
SHADEINFO {symbol} command.  The shade layer characteristics will be listed
along with the current shade environment settings.
 
To return the number of the current shade symbol, use the SHOW SHADESYMBOL
command.  To return all the shade layer characteristics of the current or a
specific shade symbol, use the SHOW SHADEINFO <symbol> <layer> command.
